Web Wiz Guide - Web Wiz Rich Text Editor release version 3.1

****************************************************************************************
**  Copyright Notice    
**
**  Web Wiz Guide - Web Wiz Rich Text Editor
**  http://www.richtexteditor.org
**                                                              
**  Copyright 2001-2005 Bruce Corkhill All Rights Reserved.                                
**
**  This program is free software; you can modify (at your own risk) any part of it 
**  under the terms of the License that accompanies this software and use it both 
**  privately and commercially.
**
**  All copyright notices must remain intact in the files and the 
**  outputted HTML.
**
**  You may use parts of this program in your own private work, but you may NOT
**  redistribute, repackage, or sell the whole or any part of this program even 
**  if it is modified or reverse engineered in whole or in part without express 
**  permission from the author.
**
**  You may not pass the whole or any part of this application off as your own work.
**   
**  You may not deactivate any adverts or links to Web Wiz Guide and its associates
**  and must remain visible when the pages are viewed unless permission is first granted
**  by the copyright holder.
**
**  This program is distributed in the hope that it will be useful,
**  but WITHOUT ANY WARRANTY; without even the implied warranty of
**  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR ANY OTHER 
**  WARRANTIES WHETHER EXPRESSED OR IMPLIED.
**
**  You should have received a copy of the License along with this program; 
**  if not, write to:- Web Wiz Guide, PO Box 4982, Bournemouth, BH8 8XP, United Kingdom.
**    
**
**  No official support is available for this program but you may post support questions at: 
-
**  http://www.webwizguide.info/forum
**
**  Support questions are NOT answered by e-mail ever!
**
**  For correspondence or non support questions contact: -
**  info@webwizguide.info
**
**  or at: -
**
**  Web Wiz Guide, PO Box 4982, Bournemouth, BH8 8XP, United Kingdom
**
****************************************************************************************




Introduction
===========================================================================================
Thank you for downloading this application and hopefully you will find it of benefit to you.

If you have not downloaded this application from Web Wiz Guide then check for the latest
version at: -

http://www.richtexteditor.org


This application uses ASP and must be run through a web sever supporting ASP. 

It has been tested with IIS on Windows 2003/2000/XP/NT4

Rich Text Enabled browsers supported include
	
	Internet Explorer 5.5+ (Windows only)
	Mozilla (Sea Monkey) 1.3+ (all platforms)
	Netscape 7.1 (all platforms)


The Web Wiz Rich Text Editor is part of a number of ASP based applications available from
Web Wiz Guide.

The Web Wiz Rich Text Editor can be used to turn any HTML textarea within a form into an
editable Rich Text Editor (thats the theory anyway).

===========================================================================================






FOR HELP ON INTEGRATION PLEASE SEE SUPPORT FORUM AT:-
---------------------------------------------------

http://www.webwizguide.info/wwf_forum/forum_topics.asp?FID=17 






Using Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Unzip all the files keeping the directory structure intact.

2. Files must be run through an ASP enabled web server or on ASP enabled web space. (check with 
your hosting company).

3. Point your web browser at the default.asp page.

===========================================================================================






Integration of Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Due to problems that image, link, etc. paths can course, the RTE files, and sub folders, need 
to be placed in the same folder as contains the web page you wish to include the RTE within.


2. The web page that contains your HTML web form textarea you wish to turn into an RTE textarea must
have an .asp extension (eg. my_own_form_file.asp (this is an example file name and not a real
file)

3. Your HTML textarea needs to be part of a form if you wish to post the user entered data to
the server. The form must also use the POST method to send the form data to the server.


3. The following onLoad event must be placed into the <body> tag of your web page to initialise the 
RTE textarea:-

	onLoad="initialiseWebWizRTE();"

An exmaple would be:-

	<body OnLoad="initialiseWebWizRTE();">


4. The code below must be copy and pasted into your web page immediately above the HTML textarea 
in your web form that is to become the RTE textarea (the HTML textarea can have pre filled content
if you wish):-


	<%

	'Declare the ASP variables used
	Dim strFormName
	Dim strTextAreaName
	
	'ID tag name of the HTML form the textarea is within
	strFormName = ""
	
	'ID tag name of HTML textarea being replaced
	strTextAreaName = ""
	
	%>
	<!-- include the Web Wiz Rich Text Editor -->
	<!--#include file="RTE_editor_inc.asp" -->




5. You are almost done, but before you can use the RTE you need to edit a couple of the
lines above you have just copyied and pasted into your web page to initialise the variables 
with the 'name' and 'id' properties of your HTML web form and your textarea tags. (Please note your
HTML web forms 'form' and 'textaera' tags MUST have 'name' and 'id' properties)

	5.1. Change the 'strFormName' variable shown below to place between the quotes ("") the 
	     name of your web form that your textarea is within (eg. strFormName = "myForm"):-
	
			strFormName = ""
			
	     If your form doesn't have a 'name' AND 'id' property then place name="myForm" id="myForm" 
	     within the form tag
	
	
	5.2. Change the 'strTextAreaName' variable shown below to place between the quotes ("") 
	     the id of your forms textarea that you wish to turn into the RTE textarea (eg. if the 
	     textarea has id="myTextarea" you would use strTextAreaName = "myTextarea"):-
	     
	     		strTextAreaName = ""
		
	     If your textarea doesn't have an 'name' AND 'id' then place name="myTextarea" id="myTextarea" 
	     within the textarea tag
	


6. Thats it, your new RTE textarea is ready to use :-)


Hopefully the instructions above were not to hard to follow. If you have problems checkout 
the free support forum at:-

	http://www.webwizguide.info/wwf_forum/forum_topics.asp?FID=17 

Being the developer, with to much inside knowledge of the application, sometimes it can be hard
to write instructions for beginners to understand, so if you can improve on the above please
drop an email to Web Wiz Guide and let me know. Thanks.

===========================================================================================









Customising the Web Wiz Rich Text Editor (RTE)
===========================================================================================

1. Edit the file 'RTE/RTE_configuration/RTE_setup.asp' with a text editor to enable and disable 
features of the RTE Editor and also setup items like file and image uploading

2. The file 'RTE/RTE_configuration/skin_file.asp' and 'RTE/RTE_configuration/default_style.css' 
can be edited with a text editor to change the look a feel of the RTE Editor

===========================================================================================







Problems with relative paths when inserting images, files, emoticons etc.
===========================================================================================

If you are submitting the contents of the RTE Editor to a file outside of the folder containing
the submission form and RTE file you may find that relative links to images, files, emoticons 
etc are no longer correct to fix this follow the instructions below:-

1. Open the file 'RTE_configuration\RTE_Setup.asp' in a text editor

2. Change the following line to true:-

	Const blnUseFullURLpath = false
Eg.:-	
	Const blnUseFullURLpath = true
	
	
3. Chnage the following to include the URL path, including your domain to the RTE folder:-

	Const strFullURLpathToRTEfiles = "http://"	
Eg.:-
	Const strFullURLpathToRTEfiles = "http://www.mywebsite.com/RTE/"

===========================================================================================







Removing Links Back to Web Wiz Guide
===========================================================================================

Many 1000's of unpaid hours have gone into developing this and the other applications 
available for free from Web Wiz Guide.

If you like using this application then please help support the development and update of 
this and future applications.

If you would like to remove the powered by logo from the application then you must purchase 
a link removal license key from Web Wiz Guide.


Payments can be made securely on-line using your credit or debit card through WorldPay or 
PayPall more information on this can be found at: -

	http://www.webwizguide.info/purchase

===========================================================================================






Donations
===========================================================================================

Many 1000's of unpaid hours have gone into developing this and the other applications 
available for free from Web Wiz Guide.

If you like using this application then please help support the development and update of 
this and future applications.

Donations can be made securely on-line using your credit or debit card through WorldPay or 
PayPall more information on this can be found at: -

	http://www.webwizguide.info/donations



Alternatively you can send donations to: -

	Bruce Corkhill
	PO Box 4982
	Bournemouth
	BH8 8XP
	United Kingdom

Please make personal checks or International money orders payable to: - Bruce Corkhill
(Sorry, I can't cash anything made payable to Web Wiz Guide) 

Please don't send a foreign check drawn on a non-UK bank, as the fees usually exceed the 
value of the donation.



For more info on donations and how Web Wiz Guide can bring professional applications for free
please see the following page: -


	http://www.webwizguide.info/donations


===========================================================================================





Windows 2003 ASP Web Hosting
===========================================================================================

If you are having problems running this application on your own web space then you can have
this application pre-installed for you when purchasing hosting from Web Wiz Hosts.

For more information on web hosting from Web Wiz Guide please see: -

http://www.webwizhosts.net 

===========================================================================================





Other ASP Applications
===========================================================================================

The following ASP Appliacations are available for FREE from http://www.webwizguide.info 

	Web Wiz Forums (award winning bulletin board system)
	Web Wiz Mailing List (full newsletter management system)
	Web Wiz Guestbook
	Web Wiz Rich Text Editor (Free replacement WYSIWYG Editor for text areas)
	Site Search Engine
	Web Wiz Polls
	Web Wiz Site News
	Web Wiz Journal
	Internet Search Engine
	Graphical Hit Counter
	Graphical Session Hit Counter
	Database Hidden Hit Counter
	Active Users Counter
	Email Form's (CDONTS)
	Email Form's (w3 JMail)
	Database Login Page
	Whois Lookup

===========================================================================================




If I have missed anything out or any bugs then please let me know by emailing me at: -

asp@webwizguide.info
